home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat2 / standard / mount.z / mount
Encoding:
Text File  |  2002-10-03  |  10.6 KB  |  199 lines
  1.  
  2.  
  3.  
  4. mmmmoooouuuunnnntttt((((2222))))                                                              mmmmoooouuuunnnntttt((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _mmmm_oooo_uuuu_nnnn_tttt - mount a file system
  10.  
  11. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_tttt_yyyy_pppp_eeee_ssss_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_mmmm_oooo_uuuu_nnnn_tttt_...._hhhh_>>>>
  14.  
  15.      _iiii_nnnn_tttt _mmmm_oooo_uuuu_nnnn_tttt _((((_cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_ssss_pppp_eeee_cccc_,,,, _cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_dddd_iiii_rrrr_,,,, _iiii_nnnn_tttt _mmmm_ffff_llll_aaaa_gggg_,,,,
  16.           _...._...._...._////_**** _cccc_hhhh_aaaa_rrrr _****_ffff_ssss_tttt_yyyy_pppp_,,,, _cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_dddd_aaaa_tttt_aaaa_pppp_tttt_rrrr_,,,, _iiii_nnnn_tttt _dddd_aaaa_tttt_aaaa_llll_eeee_nnnn_****_////_))))_;;;;
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      _mmmm_oooo_uuuu_nnnn_tttt requests that a removable file system contained on the block
  20.      special file identified by _s_p_e_c be mounted on the directory identified by
  21.      _d_i_r.  _s_p_e_c and _d_i_r are pointers to path names.  _f_s_t_y_p is the file system
  22.      type number.  The _ssss_yyyy_ssss_ffff_ssss(2) system call can be used to determine the file
  23.      system type number.  If both the _MMMM_SSSS______DDDD_AAAA_TTTT_AAAA and _MMMM_SSSS______FFFF_SSSS_SSSS flag bits of _m_f_l_a_g
  24.      are off, the file system type defaults to the root file system type.
  25.      Only if either flag is on is _f_s_t_y_p used to indicate the file system type.
  26.  
  27.      If the _MMMM_SSSS______DDDD_AAAA_TTTT_AAAA flag is set in _m_f_l_a_g the system expects the _d_a_t_a_p_t_r and
  28.      _d_a_t_a_l_e_n arguments to be present.  Together they describe a block of
  29.      file-system specific data at address _d_a_t_a_p_t_r of length _d_a_t_a_l_e_n.  This is
  30.      interpreted by file-system specific code within the operating system and
  31.      its format depends on the file system type.  If a particular file system
  32.      type does not require this data, _d_a_t_a_p_t_r and _d_a_t_a_l_e_n should both be zero.
  33.      Note that _MMMM_SSSS______FFFF_SSSS_SSSS is obsolete and is ignored if _MMMM_SSSS______DDDD_AAAA_TTTT_AAAA is also set, but
  34.      if _MMMM_SSSS______FFFF_SSSS_SSSS is set and _MMMM_SSSS______DDDD_AAAA_TTTT_AAAA is not, _d_a_t_a_p_t_r and _d_a_t_a_l_e_n are both assumed
  35.      to be zero.
  36.  
  37.      After a successful call to _mmmm_oooo_uuuu_nnnn_tttt, all references to the file _d_i_r refer to
  38.      the root directory on the mounted file system.
  39.  
  40.      The low-order bit of _m_f_l_a_g is used to control write permission on the
  41.      mounted file system:  if _1111, writing is forbidden; otherwise writing is
  42.      permitted according to individual file accessibility.
  43.  
  44.      _mmmm_oooo_uuuu_nnnn_tttt may be invoked only by a process with the super-user privilege.  It
  45.      is intended for use only by the _mmmm_oooo_uuuu_nnnn_tttt utility.
  46.  
  47.      _mmmm_oooo_uuuu_nnnn_tttt fails if one or more of the following are true:
  48.  
  49.      _EEEE_AAAA_CCCC_CCCC_EEEE_SSSS              Search permission is denied on a component of _d_i_r or
  50.                          _s_p_e_c.
  51.  
  52.      _EEEE_PPPP_EEEE_RRRR_MMMM               The calling process does not have the super-user
  53.                          privilege.
  54.  
  55.      _EEEE_BBBB_UUUU_SSSS_YYYY               _d_i_r is currently mounted on, is someone's current
  56.                          working directory, or is otherwise busy.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. mmmmoooouuuunnnntttt((((2222))))                                                              mmmmoooouuuunnnntttt((((2222))))
  71.  
  72.  
  73.  
  74.      _EEEE_BBBB_UUUU_SSSS_YYYY               The device associated with _s_p_e_c is currently mounted.
  75.  
  76.      _EEEE_BBBB_UUUU_SSSS_YYYY               There are no more mount table entries.
  77.  
  78.      _EEEE_FFFF_AAAA_UUUU_LLLL_TTTT              _s_p_e_c, _d_i_r, or _d_a_t_a_l_e_n points outside the allocated
  79.                          address space of the process.
  80.  
  81.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL              The super block has an invalid magic number or the
  82.                          _f_s_t_y_p is invalid.
  83.  
  84.      _EEEE_LLLL_OOOO_OOOO_PPPP               Too many symbolic links were encountered in
  85.                          translating _s_p_e_c or _d_i_r.
  86.  
  87.      _EEEE_NNNN_AAAA_MMMM_EEEE_TTTT_OOOO_OOOO_LLLL_OOOO_NNNN_GGGG        The length of the _p_a_t_h argument exceeds {_PPPP_AAAA_TTTT_HHHH______MMMM_AAAA_XXXX},
  88.                          or the length of a _p_a_t_h component exceeds {_NNNN_AAAA_MMMM_EEEE______MMMM_AAAA_XXXX}
  89.                          while ______PPPP_OOOO_SSSS_IIII_XXXX______NNNN_OOOO______TTTT_RRRR_UUUU_NNNN_CCCC is in effect.
  90.  
  91.      _EEEE_NNNN_OOOO_EEEE_NNNN_TTTT              None of the named files exists or is a null pathname.
  92.  
  93.      _EEEE_NNNN_OOOO_TTTT_DDDD_IIII_RRRR             A component of a path prefix is not a directory.
  94.  
  95.      _EEEE_RRRR_EEEE_MMMM_OOOO_TTTT_EEEE             _s_p_e_c is remote and cannot be mounted.
  96.  
  97.      _EEEE_NNNN_OOOO_LLLL_IIII_NNNN_KKKK             _p_a_t_h points to a remote machine and the link to that
  98.                          machine is no longer active.
  99.  
  100.      _EEEE_MMMM_UUUU_LLLL_TTTT_IIII_HHHH_OOOO_PPPP           Components of _p_a_t_h require hopping to multiple remote
  101.                          machines and the file system type does not allow it.
  102.  
  103.      _EEEE_TTTT_IIII_MMMM_EEEE_DDDD_OOOO_UUUU_TTTT           A component of _p_a_t_h is located on a remote file
  104.                          system which is not available [see _iiii_nnnn_tttt_rrrr_oooo(2)].
  105.  
  106.      _EEEE_NNNN_OOOO_TTTT_BBBB_LLLL_KKKK             _s_p_e_c is not a block special device.
  107.  
  108.      _EEEE_NNNN_XXXX_IIII_OOOO               The device associated with _s_p_e_c does not exist.
  109.  
  110.      _EEEE_NNNN_OOOO_TTTT_DDDD_IIII_RRRR             _d_i_r is not a directory.
  111.  
  112.      _EEEE_RRRR_OOOO_FFFF_SSSS               _s_p_e_c is write protected and _m_f_l_a_g requests write
  113.                          permission.
  114.  
  115.      _EEEE_NNNN_OOOO_SSSS_PPPP_CCCC              The file system state in the super-block is not
  116.                          _FFFF_ssss_OOOO_KKKK_AAAA_YYYY and _m_f_l_a_g requests write permission.
  117.  
  118.      _EEEE_2222_BBBB_IIII_GGGG               The file system's size parameters are larger than the
  119.                          size of special device _s_p_e_c. Either _mmmm_kkkk_ffff_ssss(1M) was run
  120.                          on a different overlapping device or the device has
  121.                          been changed with _ffff_xxxx(1M) since _mmmm_kkkk_ffff_ssss was run.
  122.  
  123.      _EEEE_FFFF_SSSS_CCCC_OOOO_RRRR_RRRR_UUUU_PPPP_TTTT_EEEE_DDDD        The filesystem has a corruption forcing failure of
  124.                          the mount.
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. mmmmoooouuuunnnntttt((((2222))))                                                              mmmmoooouuuunnnntttt((((2222))))
  137.  
  138.  
  139.  
  140.      _EEEE_WWWW_RRRR_OOOO_NNNN_GGGG_FFFF_SSSS            The wrong filesystem type was supplied in _f_s_t_y_p, or
  141.                          there is no filesystem on _s_p_e_c.
  142.  
  143. NNNNOOOOTTTTEEEESSSS
  144.      It is the responsibility of the caller to assure that the block size of
  145.      the device corresponds to the blocksize of the filesystem being mounted.
  146.      This is particularly important with CDROM devices, as the default block
  147.      size of the device can vary between 512 bytes and 2048 bytes.  The
  148.      _mmmm_oooo_uuuu_nnnn_tttt(1M) command manages this for filesystems via _dddd_kkkk_ssss(7M) _DDDD_IIII_OOOO_CCCC_SSSS_EEEE_LLLL_FFFF_LLLL_AAAA_GGGG_SSSS
  149.      and _DDDD_IIII_OOOO_CCCC_SSSS_EEEE_LLLL_EEEE_CCCC_TTTT ioctls.
  150.  
  151. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  152.      _ffff_xxxx(1M), _mmmm_kkkk_ffff_ssss(1M), _mmmm_oooo_uuuu_nnnn_tttt(1M), _ssss_yyyy_ssss_ffff_ssss(2), _uuuu_mmmm_oooo_uuuu_nnnn_tttt(2), _dddd_kkkk_ssss(7M),_ffff_ssss(4), _xxxx_ffff_ssss(4)
  153.  
  154. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  155.      Upon successful completion a value of 0 is returned.  Otherwise, a value
  156.      of -1 is returned and _eeee_rrrr_rrrr_nnnn_oooo is set to indicate the error.
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.